Extension point configuration

In component org.nuxeo.runtime.migration.MigrationService

Documentation

Defines migrations:

    <migration id="my_migration">
        <description label="my_migration">My Migration</description>
        <state id="v1">
            <description label="my_migration.state.v1">Initial state</description>
        </state>
          ... other states ...

          <step
            fromState="v1" id="first" toState="v2">
            <description label="my_migration.step.first">First step of the migration, from v1 to v2</description>
            <class>my.class.Migratorv1v2</class>
        </step>
          ... other steps ...
        </migration>

The migrator class for each step must implement Runnable.

Contribution Descriptors

Class: org.nuxeo.runtime.migration.MigrationDescriptor

Existing Contributions

Contributions are presented in the same order as the registration order on this extension point. This order is displayed before the contribution name, in brackets.

<extension point="configuration" target="org.nuxeo.runtime.migration.MigrationService">

    <migration id="blob-keys-migration">
      <description label="migration.dbs.blob.keys">Populate ecm:blobKeys property</description>
      <class>org.nuxeo.ecm.core.storage.dbs.BlobKeysBulkMigrator</class>
      <defaultState>unsupported</defaultState>
      <state id="unsupported">
      </state>
      <state id="empty">
        <description label="migration.dbs.blob.keys.empty">ecm:blobKeys is not populated</description>
      </state>
      <state id="populated">
        <description label="migration.dbs.blob.keys.populated">ecm:blobKeys is populated</description>
      </state>

      <step fromState="empty" id="empty-to-populated" toState="populated">
        <description label="migration.dbs.blob.keys.empty-to-populated">Populate ecm:blobKeys property</description>
      </step>
    </migration>

  </extension>

(0) nuxeo-core-storage-dbs-2025.7.12.jar/OSGI-INF/dbs-blob-keys-migration.xml Override

<extension point="configuration" target="org.nuxeo.runtime.migration.MigrationService">

    <migration id="comment-storage">
      <description label="migration.comment-storage">Migration of the comment storage model</description>
      <class>org.nuxeo.ecm.platform.comment.impl.CommentsMigrator</class>
      <defaultState>secured</defaultState>
      <state id="property">
        <description label="migration.comment-storage.property">Comments stored with their parent id as property
        </description>
      </state>
      <state id="secured">
        <description label="migration.comment-storage.secured">Comments stored under the commented document
        </description>
      </state>

      <step fromState="property" id="property-to-secured" toState="secured">
        <description label="migration.comment-storage.property-to-secured">Migrate comments under the commented document
        </description>
      </step>
    </migration>

  </extension>

(1) nuxeo-platform-comment-2025.7.12.jar/OSGI-INF/comment-migration.xml Override